iT邦幫忙

2025 iThome 鐵人賽

DAY 11
0
自我挑戰組

30 天工程師雜學之旅系列 第 11

MCP-5 用 VS Code 連線使用 MCP 工具

  • 分享至 

  • xImage
  •  

在前一篇,我們已經把 FastAPI + NASA API 專案包裝成 MCP 工具伺服器。這一篇,我們要展示如何用 VS Code 來連線,讓 AI 真正 discover 與呼叫這些工具。


1) 建立 VS Code MCP 設定檔

.vscode/mcp.json中新增以下內容:

{
	"servers": {
		"nasa-mcp": {
			"url": "http://localhost:8000/mcp",
			"type": "http"
		}
	},
	"inputs": []
}

提示:VS Code 會讀取這個設定檔,discover MCP server 並顯示工具列表。


2) 在 VS Code 中實測工具呼叫

啟動 FastAPI app:

uvicorn app.main:app

or

python main.py

然後在 VS Code 中打開 Copilot ChatMCP 插件面板 (cmd+shift+p,搜尋 MCP),你應該會看到 nasa-mcp 工具列表。點選start server來啟動 MCP server。
mcp.json中也可以啟動、重啟、或停止 MCP server。

screenshots

  • cmd+shift+p, type mcp
    palete
  • click list server
    list server
  • start/restart/stop server
    start/restart/stop
  • in mcp.json
    mcpjson

測試 Prompt

在 VS Code 中輸入(記得用agent mode):

Get today's astronomy picture from NASA

或是

Show me Mars rover photos from Curiosity on sol 1000

更多範例prompt在這裏
AI 的工作流程:

  1. 解析需求 → 需要呼叫 get_apod
  2. Discover 工具 → 找到 get_apod
  3. 填參數{"date": "2024-07-20"}
  4. 呼叫工具 → 向 FastAPI MCP server 發送請求
  5. 取得回傳 → 顯示圖片標題、說明與 URL

screenshot
chat

3) 疑難排解

  • 連不到 Server:確認 FastAPI 是否在 127.0.0.1:8000,以及設定檔 URL 是否一致。
  • 工具列表為空:檢查 mcp initialization 是否在定義route之後。
  • CORS 問題:若在瀏覽器環境中使用,記得在 FastAPI 加 CORSMiddleware

下一篇預告

第四篇會介紹如何 擴充 MCP 工具 —— 加上快取、批次查詢、背景任務與觀測,讓你的 MCP 工具更接近實際產品需求。


上一篇
MCP-4 在 FastAPI 中整合 MCP 並暴露工具
下一篇
MCP-6 MCP 系列最終篇:從 Demo 到產品級應用
系列文
30 天工程師雜學之旅22
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言